home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 6 / MacMania 6.toast / / Internet software / Bookends Tutorial & Manual□ / Bookends Tutorial & Manual / Bookends Tutorial & Manual.rsrc / TEXT_169.txt < prev    next >
Text File  |  1997-03-11  |  17KB  |  451 lines

  1.  
  2. Utilities Menu
  3.  
  4. UTILITIES MENU
  5.  
  6.       JournalGlossary‚Ķ
  7.  
  8.       The Journal Glossary provides a rapid means of entering journal names and
  9.       customizing bibliographies.
  10.  
  11.  
  12. Entering journal names into the Glossary
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.       A Journal Glossary entry contains 3 items: the abbreviation for the journal, the
  39.       journal‚Äôs short name, and the journal‚Äôs full name.
  40.  
  41.       To navigate the list, use TAB to move from left to right, Shift-TAB to move from
  42.       right to left, and the Up and Down Arrows to move within one column.
  43.  
  44.       The buttons at the bottom of the dialog let you
  45.  
  46.       1)    Add Journal‚ÄîAdd a new journal entry.
  47.  
  48.       2) Delete Journal ‚ÄîRemoves the currently selected journal entry.
  49.  
  50. 3) Print ‚Ķ‚ÄîPrints the list of journals and their abbreviations.
  51.  
  52.  
  53. Entering journal names into references
  54.  
  55. To use the Journal Glossary while entering a reference, you enter the abbreviated journal name (e.g., ‚Äúji‚Äù, without the quotes) in the Journal category. When you ‚Äúleave‚Äù the Journal category (by pressing TAB, Return, or clicking outside of the field), Bookends replaces the abbreviation with either the short or the full journal name. Preferences contains buttons that tell Bookends which form of the journal name entered in the Journal Glossary, short or full, to use.
  56.  
  57.  
  58. Selecting journal names in a bibliography
  59.  
  60.       In addition to making it easier to enter journal names, the Journal Glossary allows
  61.       you to automatically generate bibliographies that contain either the short or the long
  62.       form of the journal name. In the Order field of each Format, the letter "j" tells
  63.       Bookends to use the short form and the letter "f" the full form of the journal name.
  64.       There, when Bookends is making a bibliography and encounters a "j" or an "f" in
  65.       the Format, it fetches the journal name from the reference and looks in the Journal
  66.       Glossary to see if it is entered there. If the journal name is in the Journal Glossary,
  67.       Bookends selects either the short (if a "j") or the full (if an "f") form to put in the
  68.       bibliography. If the journal name isn‚Äôt in the Journal Glossary, Bookends uses the
  69.       name as it was entered in the reference.
  70.  
  71.       +    The form of the journal name entered in the reference itself (short or full) doesn‚Äôt
  72.             matter when a bibliography is being created. If the journal name is in the Journal
  73.             Glossary, Bookends finds it regardless of whether it is the short or the full form.    
  74.  
  75. Adding periods to journal names in a bibliography
  76.  
  77.       If a journal name in a reference lacks periods (e.g. J Biol Chem, the style used in
  78.       Medline databases) but the Journal Glossary version has periods (e.g. J. Biol.
  79.       Chem.), periods will be added when the bibliography is generated.
  80.  
  81.       +    Even if the Journal Glossary short journal forms are entered with periods, you
  82.       always have the option of selecting the Remove Journal ‚Äú.‚Äùs in the actual Format if
  83.       periods are not desired.    
  84.  
  85. Transferring Journal Glossaries between databases
  86.  
  87.       Each database has its own Journal Glossary. You can transfer the Glossary to other
  88.       databases with the Transfer References/Formats option.
  89.  
  90.  
  91.  
  92.       Sort All References‚Ķ
  93.  
  94.       You can permanently sort all the references in the database by two fields
  95.       simultaneously. In addition, the order of the sort (ascending, from lowest to highest
  96.       value, such as A to Z) or descending (from highest to lowest value, such as Z to A) 
  97.       can be specified.
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120. +          If you are using Citation by number in documents to be operated on by the Scan
  121.             a Document option, you shouldn‚Äôt permanently sort the database until you are
  122.             finished with the manuscript: the references will have different numbers after
  123.             sorting.
  124.  
  125.  
  126.       Show Attachments
  127.  
  128.       This is the menu equivalent of the Attach button in each reference window. The only
  129.       advantage that it has over the Attach button is that you can select a subset of the filed
  130.       name(s) in the Keywords field (highlight them) and use the Show Attachments menu
  131.       item to bring up these windows (the Attach button will bring up windows of all files
  132.       in the Keywords field).
  133.  
  134.  
  135.       Scroll
  136.  
  137.       Scroll is used when the size of the Bookends window is larger than the monitor
  138.       (screen). In this case, you use the mouse pointer to drag the viewing window,
  139.       allowing you to see the entire Bookends window, even if the monitor is too small to
  140.       display all of the window at once.
  141.  
  142.  
  143.  
  144.       Transfer References/Formats
  145.  
  146.       This option lets you transfer References, Formats, Journal Glossaries, and Search
  147.       Strategies from one Bookends database to another.
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.       +    Whenever you receive an update to Bookends, use this option to transfer your
  174.             data from the older to the newer version of Bookends.
  175.  
  176.       The options are:
  177.  
  178. Source Bookends Database. Clicking on this button brings up the Open dialog box.
  179.       Choose the Bookends database that you want to transfer information from.
  180. Destination Bookends Database. Clicking on this button brings up the Open dialog
  181.       box. Choose the Bookends database that you want to transfer information to.
  182. Transfer References. If you want to transfer the references between the database,
  183.       this button should be checked. Any references in the destination database
  184.       remain‚Äîthe references in the source database are appended to the destination
  185.       database. This option will transfer All references or just those in the Hits List. The
  186.       latter is useful when you want to transfer a subset of the references between
  187.       databases. If the with unique ID numbers option is checked, the references will
  188.       retain their original unique ID numbers in the the new database (this is not
  189.       recommended‚Äîtransfer unique IDs only when you have used these to keep track of
  190.       reprints or to designate references in manuscripts). If Update Lists is checked,
  191.       Bookends will add the Authors, Editors, Keywords, and Journals in the transferred
  192.       references to the Lists in the destination database.
  193. Transfer Journal Glossary. If you want to transfer the Journal Glossary, this
  194.       button should be checked. The entries are appended to any names already in the
  195.       Journal Glossary (if any).
  196. Transfer Search Strategies. If you want to transfer the Search Strategies, you
  197.       should check this button.
  198. Transfer Formats. If you want to transfer the Formats, then this button should be
  199.       checked. You can have all the Formats presently in the new database deleted during
  200.       this process.
  201.  
  202.       +    If a format you are transferring already exists in the destination database (same
  203.             name and Type), the format in the destination database will be overwritten by the
  204.             format in the source database.
  205.  
  206. Transfer Labels. Check this button only if you have changed the labels (the names of
  207.       the categories or fields) from the originals supplied with Bookends.
  208. Transfer. Clicking on this button starts the actual transfer. Be sure the source and
  209.       destination database have been selected, and that the other buttons are correctly
  210.       checked. If you are transferring references, you are asked for the name of the
  211.       exported reference file. Normally, you can accept the default name. The temporary
  212.       file is deleted when the transfer is completed.
  213. Done. Returns to the first reference in the database.
  214.  
  215.  
  216.     User-Defined Imports‚Ķ
  217.  
  218. You can create templates that tell Bookends how to import reference information downloaded from a wide variety of on-line services and CD-ROMs. The Utilities menu contains the option User-Defined Imports‚Ķ When selected, you see the following screen:
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243. When filled out, this screen (and the next) will contain all the information Bookends needs to import reference information from text files downloaded from most on-line and CD-ROM sources.
  244.  
  245. +    For Bookends to import references, the specific bits of information in the file must
  246.       be tagged. Tags are labels that identify the type of information that is to follow. Here
  247.       are three examples of the different ways the Authors field might be tagged:
  248.  
  249.       AU - Smith AR
  250.  
  251.       Author(s): Smith AR
  252.  
  253.       Journal Author
  254.         Smith AR
  255.  
  256. Designing a new importer
  257.  
  258. Click on the button New and enter the name of the new importer. Usually, the name will be the same as the information provider (e.g. CD Plus-Medline, ERIC, etc.). If an importer was already selected (i.e. its name was in the pop-up menu labeled Importers:), a duplicate of that importer will be created and given the newly assigned name. This makes it easy to use one template as the basis for creating others.
  259.  
  260. The user-defined templates are stored in a folder (called ‚ÄòUser-defined Imports‚Äô) that resides in the same folder as the Bookends Plus application. To access a template for viewing, modification, or to make it the basis for a new template, use the Importers: pop-up menu. You cannot delete templates from within Bookends. To delete a template, simply remove it from the User-defined Imports folder and place it in the Trash.
  261.  
  262. The number of importers allowed is unlimited. To use an already defined importer in Bookends, use the Import References‚Ķ item in the File menu as you normally would. After you select a file to import, the user-defined importers will appear at the bottom of the menu from which you select the source of the file.
  263.  
  264. Specifying where the information goes
  265.  
  266. On the left side of the screen is a column of fields labeled Field tags, each field followed by an arrow and the name of a Bookends reference category. You can tell Bookends what information you want to keep, and where it should go, by entering the tag for each field of interest. Suppose the downloaded file has the following fields:
  267.  
  268.             UI:    123456789 ‚Äî unique identifier
  269.             AU:    Jones, Ron ‚Äî author(s)
  270.             TI:    This is my article ‚Äî title
  271.             DA:    1995 ‚Äî date
  272.             PY:    12-24 ‚Äî page range
  273.             LA:    English ‚Äî language
  274.             AD:    State University ‚Äî address of corresponding author
  275.  
  276. To import the information into the corresponding fields in Bookends, you might fill out the Field tags as follows:
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298. Case matters ‚Äî ‚ÄòAU:‚Äô is not the same as ‚Äòau:‚Äô.
  299.  
  300. Note that in this example you must include the colon in the tag definition. That is because when Bookends analyzes the text for a tag designation, it looks at one word at a time, and a word ends with either a space or a Return character. If the tags are
  301.  
  302.             UI - 123456789
  303.             AU - Jones, Ron
  304.             etc.
  305.  
  306. you would define the unique identifier tag as ‚ÄúUI‚Äù, without the dash, since UI is immediately followed by a space.
  307.  
  308. You can import more than one tagged field into any category simply by putting a space between the tag definitions (e.g., importing to the Notes category in the above figure). If the category is a scrolling field, Bookends will put a Return character between the imported tagged fields. If it is not a scrolling field, Bookends will place a semicolon between the imported tagged fields.
  309.  
  310. What if the tag consists of more than one word? You might encounter a downloaded file that provides reference information like this:
  311.  
  312.       UI: Unique Identifier
  313.         123456789
  314.       AU: Article Author(s)
  315.         Jones, Ron
  316.       etc.
  317.  
  318. In this case, enter the last word in the tag. In this example, you would enter ‚ÄòIdentifier‚Äô and ‚ÄòAuthor(s)‚Äô in the appropriate places in the Field tags portion.
  319.  
  320. Identifying the beginning of a reference
  321.  
  322. You must tell Bookends what constitutes the beginning of a new reference in the downloaded file. Typically, this will be a field tag. In the example given above, you would enter
  323.  
  324.  
  325.  
  326. Again, you must enter the entire word, which ends in a space or a Return (so don‚Äôt enter the dash here).
  327.  
  328. There may be cases in which different tags are used to begin different reference types in a single file. You can tell Bookends to look for more than one ‚Äúnew reference‚Äù tag by entering the different tags in this field, making sure to separate each one with a space.
  329.  
  330. +    The tagged field that identifies the start of a new reference will not be imported into
  331.       Bookends unless it is also entered in the Field tags portion of the definition window.
  332.  
  333. References that begin with numbers
  334. Numbers may sometimes be used to distinguish one reference from another in reference files obtained from on-line services. An example might be:
  335.  
  336. 1
  337. AU Niklinska, B
  338. TI Two years behind the mast
  339. ...
  340.  
  341. 2
  342. TI This reference has no author
  343. ...
  344.  
  345. You can indicate that a new reference begins with a number (#) and that a category ends with a Return followed by one or more capital letters. In this case, Bookends will recognize a number following a Return (as well as capital letters) as signifying the end of a category and the beginning of a new reference. When you enter the # symbol as defining a new reference in the User-defined Imports window, this features is indicated with the words "(or a number)" as follows:
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356. +    You must enter just the # symbol. If any other characters are entered Bookends will
  357.       look for the character #, not a number.
  358.  
  359. +    If a number appears at the beginning of a line of text (that is, after a Return)
  360.       Bookends will assume that this is the beginning of a new reference and import the
  361.       rest of the information accordingly. Therefore, if categories are defined by capital
  362.       letter tags, it is preferable to define the beginning of a reference as a tag (e.g. AU)
  363.       rather than as a number (#).
  364.  
  365. Although not designed for this purpose, specifying that a reference begins with a number can be useful if you want to import references from an existing bibliography.
  366.  
  367. Identifying the end of a tagged field
  368.  
  369. You must let Bookends know how to identify the end of a field.
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377. All fields end after a Return character, but not all Returns indicate the end of a field! Each time Bookends encounters a Return in the file it is importing, it checks to see if what follows indicates the end of the field.
  378.  
  379. This is an example of a file in which spaces are used to indent information in a field (the relevant spaces are shown as diamonds (‚óä), and Returns are shown as ‚Äò¬¨‚Äô):
  380.  
  381.             ‚óäTI‚óä‚óä- Identification of an Epstein-Barr virus early gene encoding a second¬¨
  382.             ‚óä‚óä‚óä‚óä‚óä‚óäcomponent of the restricted early antigen complex.¬¨
  383.             ‚óäAB‚óä‚óä- When the latent Epstein-Barr virus (EBV) genome in B95-8 cells is¬¨
  384.             ‚óä‚óä‚óä‚óä‚óä‚óäinduced into a replicative phase, two abundant early RNAs are‚Ķ
  385.  
  386. Note that tags are preceded by a single space and followed by two spaces. Information after a return within a field is preceded by 6 spaces. The correct definition of the ‚Äúend of field‚Äù in this case would be:
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393. In other cases, spaces may not be used to format the output, and all information may begin at the left margin (or indented the same number of spaces in from the left margin). For example:
  394.  
  395.             TI‚óä‚óä- Identification of an Epstein-Barr virus early gene encoding a second¬¨
  396.             component of the restricted early antigen complex.¬¨
  397.             AB‚óä‚óä- When the latent Epstein-Barr virus (EBV) genome in B95-8 cells is‚Ķ¬¨
  398.             induced into a replicative phase, two abundant early RNAs are‚Ķ
  399.  
  400. In this case, you can tell Bookends that two capital letters after a Return indicate that the field has ended:
  401.  
  402.  
  403.  
  404.  
  405. Unlike reference information you enter into Bookends, user-defined importer templates must explicitly be Saved. Bookends will prompt you if you try to leave or quit without saving an importer that has been edited since it was last saved.
  406.  
  407. Viewing the Text File‚Ķ
  408.  
  409. When creating a template, it is helpful to view an example of a downloaded text file from the on-line service or database. To do this, click on the button 
  410.  
  411.  
  412.  
  413.  
  414. The text file you select from the dialog box will appear in a window above the template.
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428. This window contains up to 20,000 characters from the text file (it is truncated at 20,000 characters if the file is longer than this), and is for display only ‚Äî you cannot edit the text in this window.
  429.  
  430. You can, however, Copy selections from this window and Paste them into your template. Bookends will automatically truncate any copied text to the first word in the selection. Thus, if you select the characters ‚Äòstructurally related peptides‚Äô and then do a Copy, Bookends will put the characters ‚Äòstructurally‚Äô in the clipboard.
  431.  
  432. Show Invisible Characters is a very useful option that replaces spaces, returns, and tabs with visible characters. Spaces are replaced with ‚óä, Tabs with ‚àÜ, Returns with ¬¨. This is extremely useful when you are trying to determine how to define the end of a tagged field.
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445. +     If you Copy from the window with Show Invisible Characters checked ON,
  446.       Bookends will not copy the characters ‚óä, ‚àÜ, and ¬¨ to the clipboard.
  447.  
  448.   
  449. .                                                          ...Utilities Menu Continued--->
  450.  
  451.